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How to Use This Guide 


The Messenger™ Electronic Mail program consists 

of text and program files that allow messages to be 
created, sent and filed. The messages originate at user 
workstations, and are filed on a shared hard disk. 


This manual should be read by individuals (we call them 
system managers) who will be installing and configuring 
the Messenger software for the first time. Once the 
software has been installed and configured, there are a 
few maintenance procedures to be performed by the system 
manager. The Messenger User’s Manual provides complete 
instructions for use of this software once it has been 
installed and configured. 


The procedures described in this manual are not 
on difficult. We do assume that your installation has been 
set up in accordance with the PLAN Series Physical 
Planning and Installation Manual. The PLAN Series 
manuals that are prerequisites to this manual are: 
General Information Manual 
PLAN File Server User’s Manual 


PLAN File Server Installation and Operation 
Manual 


PLAN File Server User’s Guides for your 
environment(s) 


Messenger User’s Manual 
om A bibliography is provided at the end of this manual. 


The material in this document applies to Version 2.5 of 
the Messenger software. 


HOW TO 


We welcome criticisms and suggestions. Forms for 
reporting program errors and documentation errors or 
inadequacies are provided at the back of this guide. 
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Chapter 1 


Installing the System 


1.0 Introduction 


This chapter describes installation of the electronic 
mail programs and text files on the network shared hard 
disk. 


Note that we use the term “environment” to refer to a 
particular type of microcomputer running a particular 
operating system. Since the electronic mail program 
supports a number of environments, we do not include 
details about each environment in the main body of the 
manual. We have placed environment specific information 
and instructions in the appendices of this manual. The 
PLAN File Server User’s Guides for the environments 
supported in your installation are prerequisite reading 
for the electronic mail program installers and system 
managers. These guides provide useful details about 
supported video cards, special key-sequences pertinent 
to a particular environment, etc. 


1.1 Electronic Mail Program installation 


The Messenger electronic mail software consists of four 
files: Mail, Maiihelp, Mailnews, and Mailinfo (plus, in 

some environments, a suffix for each file. See 

environment appendices for suffixes). Mail is the 

executable codefile. Mailhelp contains the list of 

responses displayed when the HELP command is entered. 
Mailnews and Mailinfo contain the text displayed in 

response to the Messenger commands NEWS and INFO. The 
system manager may use these files for company and/or 
mail system news and information. 


These files will reside in a volume called 
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/MAIN/PRODUCTS/MESSENGER/X.X/COMPUTER/ENVIRON 
For example, 
/MAIN/PRODUCTS/MESSENGER/X.X/IBMPC/UCSD/PASCAL 


In order to complete installation of the electronic mail 
program, you must transfer the contents of this 
distribution volume into the appropriate shared library 
volume. To accomplish this, turn to the appendix for 
your environment and follow the installation 
instructions located there. 


if your hard disk does not contain the shared library 
and products volumes necessary to complete the 
installation process, contact your network 
representative. 


lf you ordered your software after ordering your system, 

it has been distributed on a tape cartridge. Before 

following the installation instructions, you must oo 
restore the software on tape to the hard disk. To do 

this, 


a. from the file server, type QUIT 

b. from the utilities menu, select b) partial tape 
dump/restore 

c. from the menu for this utility, select L)ist to 
determine the specific pathnames on your tape 

d. now select R)estore. The program prompts you for 
pathnames you wish to restore. Enter those 
pathnames you found in step c). 


() 
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Chapter 2 


Operating the System 


2.0 The User's Mail File 


As described in the Messenger User’s Manual, every 
electronic mail program user has a mail file in which 

can be stored copies of messages received and composed. 
The electronic mail software creates this file (which is 
actually a virtual volume on the hard disk). The file is 
mounted automatically each time that the user executes 
the electronic mail program. 


2.1 The Mail File Pathname 
The pathname of the Mail file consists of three parts: 
1. A prefix 

2. User's indentification 


3. The name “MAIL” 


The default prefix is /MAIN/USERS. For example, a 
typical user's mail file might be: 


/MAIN/USERS/SMITH/MAIL 


The user’s identification often consists of a first 
name, last name, or set of initials. The three parts of 
the pathname can be set automatically at startup to 
values other than the defaults. This is explained in 
Chapter 7 of the Messenger User's Manual. 


OPERATION 


2.2 The Newmail Directory 


Each message sent through the electronic mail program 
exists as a network virtual volume with a pathname ao 
consisting of four parts: ae 


1. Prefix 

2. User identification 

3. The name “NEWMAIL” 

4. Message identification number 


The default prefix of each pathname is the same as for 

the MAIL file. The identification for incoming mail is 

the same as for the MAIL file. For outgoing mail, the 
identification is that of the recipient. In the case of 

multiple recipients, multiple files are created, each 

with a unique pathname, since each is a virtual volume. ro 
The (default) third part of each pathname is NEWMAIL. 

The fourth part is an identification assigned to each 

message by the Messenger, which is unique to that 

message. 


In addition to creating a Mail file for each new user, 
the Messenger creates for each new user a directory with 
the pathname 


Prefix/UseriID/NEWMAIL, 


in which will be listed any new messages received by the 
user. 


2.3 Mounting MAIL and NEWMAIL 

M 
Each time that the electronic mail program is invoked at s= 
a user station, the Messenger looks for and executes any 
mail commands in a defaults file on the user's boot or 
work disk, and determines the identity of the user from 
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the defaults file or by asking 
Who are you? 


NOTE: The instructions for configuring the defaults 
file on the user’s boot or work volume are in Chapter 7 
of the Messenger User’s Manual. 


if no mail file exists for the user, the Messenger 
displays 


Not found: /MAIN/USERS/SMITH/MAIL 
There is no mail file for SMITH 
Create one (Y/N)? 


For “Y”, 


Mail file size will be 100 blocks 
OK (Y/N)? 


For a mail file of some other size, type in “N” and the 
Messenger will prompt 


Enter size in blocks: 


The size must be between 10 and 1000 blocks. Blocks are 
512 bytes each. A mail file for Smith will then be 

created (assuming that “Create” access rights exist) and 
the file will be mounted automatically each time that 

the Messenger is executed by the user. 


The Messenger examines the user’s newmail directory when 
the READ or CHECK commands are executed. Any files 
listed in Newmail will be reported as new messages. When 
a message is read, it is removed from the user’s NEWMAIL 
directory unless the user chooses to keep the particular 
message in the Newmail directory. 


Notice that all messages filed by the user are located 


in a single Mail file. However, each piece of received 
mail exists as a separate network virtual volume, listed 


2-3 


OPERATION 


in the directory /Prefix/User/NEWMAIL. 


After the Messenger has determined the identity of the 

user, it looks for two free virtual drives upon which to 

mount the mail file and any succession of NEWMAIL files. o 
If two virtual drives are not available, the Messenger ove) 
will display mount information for all current virtual 

drives at that station and ask the user which drive can 

be used for Mail and Newmail. When the user enters a 

virtual drive number or letter, the volume currently 

mounted on that drive is unmounted (and not remounted 

later), and the drive is used by the Messenger. In some 
environments, a real drive can also be specified. It 

will be made virtual and used, and will be changed back 

to real when the program terminates (see the environment 
appendices at the end of this manual). 


NOTE: The drives used for the boot volume and shared 
library volume cannot be used for the MAIL and NEWMAIL 
files. 


If the Mail and Newmail volumes are unmounted while the A 
mail system is in use (by using the FS command, or by 
mounting Newmail on the same drive number as Mail, for 
example), the Messenger will be unable to file or 

receive mail. Issuing the File command from the 

Incoming or Outgoing mail menus will then result in a 

“FAILED READING BLOCK...” error message, since the file 

to be read or written into is not currently mounted. 


Note: The user may mount other volumes on the Mail and 
Newmail drives before exiting by using the NET command 

mode (Messenger User Manual, Section 6.6). The 

-Messenger will not remount volumes automatically when it 

is through. However, the user’s current default 

directory, which is saved and overridden by 
/Prefix/User/NEWMAIL during initialization, is restored 

when the Messenger exits. The change in default ao 
directory has observable effects only if FS commands are s 
executed from within the mail system. The FS command Set 

Dir should not be used from the Messenger. 
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Chapter 3 


Tailoring Your System 


3.0 Automatic Startup 


Your system has various startup command facilities that 
can be used to facilitate entry into the mail system via 
the processing of STARTCMD and/or DEFAULTS files. 


3.1 Startcmd File 


A user station can be configured so that a startup 
program is automatically executed when the station is 
booted. In some environments, this program attempts to 
read a file called Startcmd (the file name includes a 
suffix in some environments) from the prefixed or logged 
in disk and interprets each line in the file as a 

command. Including the word “MAIL” as a command line in 
Startcmd will cause the mail system to run automatically 
when the station is booted. Startcmd commands that do 
not relate to the mail system are described in detail in 
the PLAN File Server User’s Manual. 


3.2 Defauits File 


When the Messenger is executed, its first action is to 
read the user’s DEFAULTS file. (The filename includes a 
suffix in some environments.) Any command lines in this 
textfile that begin with the word “Mail:” are executed 
automatically. 


The following mail commands are allowed (all commands 
must be preceded by “mail:”; upper and lower case are 
allowed). Underlined values are variables input by the 
user. Information specific to a workstation environment 
is found in Section 3 of its environment appendix at the 
back of this manual. 


TAILORING 


Mail: Set User name 
Identifies the user as “name”. The Messenger will mount m~ 
/Prefix/Name/Mail a 
and 
/Prefix/Name/Newmail/MessagelD 
automatically. A password may be included, in the form 
name:password. When the Set User command is present, 
the Messenger will not ask “Who are you?” at 
initialization. 
Mail: Set DriveA x 
Sets the drive letter or number used for filed mail to 
x; otherwise the Messenger looks for any available 
drive. The drive must be virtual. on 
Mail: Set DriveB y 
Sets the drive letter or number used to mount new mail 
to y; otherwise the Messenger looks for any available 
drive. Drive must be virtual. 
Mail: Set Height n 
Sets screen page height to n lines; default is 24. When 
displaying messages, the Messenger asks MORE?(Y/N) after 
n lines. 


Mail: Set Width n 


Sets screen width to n columns. Screen width will affect 
the formatting of some prompt lines. The default is 80. 
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Mail: Set Prefix path 


Sets pathname prefix for mail and newmail files. 

Default is /MAIN/USERS. READ access must be provided for 
all directories in the prefix path. Passwords may be 
included. All users of the Messenger must have the same 
prefix and Newmail; otherwise, messages will not be sent 
correctly. 


Mail: Set Mailfile path 


Sets the complete pathname for Mailfile. This command 
overrides default pathname Prefix/User/Mail and uses the 
specified pathname. READ, WRITE access must be provided. 
Passwords may be used. 


Mail: Set Newmail name 

Sets final name of Newmail pathname, appended to 
Prefix/User/. Used for incoming and outgoing mail. 
Default is “NEWMAIL”. DELETE and READ access must be 
provided for the NEWMAIL directory, and CREATE access 


must be provided for outgoing newmail directories. 
Passwords may be included. 


Mail: READ 


Causes the Messenger to automatically execute the READ 
command after initialization. 


Mail: CHECK 

Causes the Messenger to automatically execute the CHECK 
command after initialization. 

3.3 Access, Usage, and Protection 

Network file protection facilities are discussed in 


detail in the PLAN File Server User’s Manual. Briefly, 
the mail system user can prevent access to his or her 
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Mail and Newmail files by setting passwords in the file 
pathnames and limiting public and group access rights to 

those files. From within the mail system, this is 

accomplished by issuing FS PROTECT commands. For oo 
example, L 


FS PROTECT /MAIN/USERS/SMITH/NEWMAIL, 
PUBACC=C,GRPACC=,PRVACC=RWECD,PRVPW=XYZ 


causes the private password “xyz” to be set for Smith’s 
Newmail file, and read and write access to be restricted 
to private use. No group access is allowed, but the 
public is given “create” access so that messages from 
other mail users can be created in the Newmail 
directory. The Mail file is accessed only by the user 
who owns it; there need be no public access to it at 
all. 


The following access must be provided for the system to 

function: 

en 

1. READ access for Mail/Newmail prefix (all users must = 
have same prefix and Newmail). 


2. READ and WRITE access for your own Mailfile. 


3. DELETE and READ access for your own Newmail 
directory. 


4. CREATE access for other Newmail directories. 


A private password, once it has been set, can be entered 
in several ways: 


1. By issuing a Network “SET PRVPW” command from the 
NET program before the Messenger is used. 


am 


2. By including the SET PRVPW command in the STARTCMD ` _ 
file. 


3. By including the private password in the 
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appropriate Mail Set commands in the user’s 
DEFAULTS file. For example, 


SET USER NAME:PASSWORDA 
SET PREFIX /MAIN/USERS:PASSWORDB 


would cause the program to mount 
/MAIN/USERS/NAME/MAIL at startup, and to provide 
the necessary passwords PASSWORDA and PASSWORDB. 


The system default is no protection. 


NOTE: To prevent the public creation of new entries, set 

a password on /MAIN/USERS. This password will prevent 
unauthorized use of the mail program, and will prevent 

the sending of mail to non-existent recipients (via the 
creation of new NEWMAIL directories) when the name or ID 
of a TO: recipient is mistyped. 
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Appendix A 


Installation and Maintenance of the 
Messenger Program in the Apple // 
Pascal Environment 


A.0 Introduction 

This appendix provides instructions and information 
specific to installation and maintenance of the 
electronic mail software in the Apple // Pascal 
Environment. 


It contains the following: 


Instructions for installation of the electronic mail 
software in the Apple // Pascal environment. 


Instructions for maintenance of the electronic mail 
software in the Apple // Pascal environment. 
A.1 installation of the Messenger Electronic Mail 
Program in the Apple // Pascal Environment 
Installation of the electronic mail software in the 
Apple // Pascal environment consists of transferring the 
mail program and text files from the distribution volume 
called: 
/MAIN/PRODUCTS/MESSENGER/X.X/APPLE2/UCSD/PASCAL 
to the shared library volume called: 
/MAIN/LIB/APPLE2/UCSD/PASCAL 


To accomplish this, do the following: 


Boot into the volume 


APPLE // PASCAL 


//PRODUCTS/MESSENGER/X.X/APPLE2/UCSD/PASCAL 
The installation software is automatically executed. o~ 


This autoinstall file will mount the library READ/WRITE 

and transfer the contents of your products volume to the 
library. It will keep you posted of its progress. If 

anything goes wrong, please contact your network support 
representative for assistance. 


You have now finished the installation procedure for the 
Apple // Pascal environment. Now turn back to the main 
body of this manual and follow the instructions for 
configuring the electronic mail software. 


A.2 Maintenance of the Mail Program 


Each time a new user is added to the network, create a 
newmail volume for that user. ao 


/YOURPREFIX/USERID/NEWMAIL 


See Chapter 2 for details. Users may also require 
assistance in setting up the defaults file for use with 
the Messenger program. This procedure is described in 
Chapter 7 in the Messenger User's Manual. 


A.3 Automatic Startup 
NESTAR.START 
NESTAR.START is a program that can run automatically 


when the user station is booted. NESTAR.START first 
checks the booted disk for a file named SYSTEM.STARTUP. 


ee 


APPLE // PASCAL 


if present, SYSTEM.STARTUP is chained to. Otherwise, 
NESTAR.START attempts to read a file from the booted 
disk called STARTCMD.TEXT, and interprets each line as a 
command. Including the word “MAIL” as a command line in 
STARTCMD.TEXT will cause the mail system to be run 
automatically when the station is booted. 


NESTAR.START commands that do not relate to the mail 
system are described in detail in the PLAN File Server 
User’s Manual. 


The Messenger expects to have available the full memory 
space of a non-swapping 64K Apple. If you are using 
installable device drivers, turn on the Pascal swapping 
mode to compensate for memory space taken by your 
drivers (that is, include the line SWAP ON in 
Startcmd.Text.) 


DEFAULTS.TEXT 


When the Messenger is executed, its first action is to 

read the file DEFAULTS.TEXT, if it exists on the boot 
volume. Any command lines in this textfile that begin 

with the word “MAIL:” are executed automatically. 

Section 3.2 explains what mail commands can be in 
DEFAULTS.TEXT. in the commands “Set DriveA x” and “Set 
DriveB y”, the x and y should be Pascal drive numbers 
such as 9 or 10. 


A.4 Messenger Filenames 


Messenger filenames with correct suffixes for this 
environment: 


MAIL.CODE 
MAILHELP. TEXT 
MAILINFO.TEXT 
MAILNEWS.TEXT 
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Appendix B 


Installation and Maintenance of the 
Messenger Electronic Mail Program in the 
Apple /// SOS Environment 


B.0 introduction 


This appendix provides instructions and information 
specific to installation and maintenance of the 
electronic mail software in the Apple /// SOS 
Environment. 


it contains the following: 


instructions for installation of the electronic mail 
software in the Apple /// SOS environment. 


Instructions for maintenance of the electronic mail 
software in the Apple /// SOS environment. 


B.1 Installation of the Messenger Electronic Mail 
Program in the Apple /// SOS Environment 


Installation of the electronic mail software in the 
Apple /// SOS environment consists of transferring the 
electronic mail software from the distribution volume 
called 

/MAIN/PRODUCTS/MESSENGER/X.X/APPLE3/SOS 
to the shared library volume called 


/MAIN/LIB/APPLE3/SOS 


APPLE /// SOS 


To accomplish this: 
Boot into Pascal. The SOS.DRIVER on this boot diskette 
must include the network driver. In addition, the Pascal on 
diskette must contain both a Startcmd.Text file that = 
causes the 

/MAIN/LIB/APPLE3/SOS 
volume to be mounted, and a SYSTEM.STARTUP file that 
processes the Startcmd.Text file or the NET.CODE program 
and System.Library. 
Type the following: 

X (for execute) 

/LIB/NET (to execute NET.CODE) 


LIST /MAIN/PRODUCTS/MESSENGER 


() 


or, alternatively 
X NET 
if NET.CODE is on your boot diskette. 
Select the directory name which is the most recent 
version number and substitute that name for the X.X in 


the following instructions. 


MOUNT /MAIN/PRODUCTS/MESSENGER/X.X/APPLE3 
AINSTALL,D2 (typed on one line) 


Q (to quit NET.CODE and return to the main 
Pascal command line) 


X (for execute) — 
A3MESNGR:MINSTALL 


You have now finished the installation procedure for the 
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Apple /// SOS environment. Now turn back to the main 
body of this manual and follow the instructions for 
configuring the electronic mail software. 


B.2 Maintenance of the Mail Program 


Each time a new user is added to the network, create a 
newmail volume for that user. 


/YOURPREFIX/USERID/NEWMAIL 


See Chapter 2 for details. Users may also require 
assistance in setting up the defaults file for use with 
the Messenger program. This procedure is described in 
Chapter 7 in the Messenger User’s Manual. 


B.3 Automatic Startup 
NESTAR.START 


NESTAR.START is a program that can run automatically 
when the user station is booted. It appears on the boot 
diskette as SYSTEM.STARTUP and upon booting, it attempts 
to read a file from the booted disk called 

STARTCMD.TEXT, and interprets each line as a command. 
Including the word “MAIL” as a command line in 
STARTCMD.TEXT will cause the mail system to be run 
automatically when the station is booted. 


NESTAR.START commands that do not relate to the mail 
system are described in detail in the PLAN File Server 
User's Manual. 


DEFAULTS.TEXT 
When the Messenger is executed, its first action is to 
read the file DEFAULTS.TET, if it exists on the boot 


volume. Any command lines in this textfile that begin 
with the word “MAIL:” are executed automatically. 
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Section 3.2 explains what mail commands can be in 
DEFAULTS.TEXT. In the commands “Set DriveA x” and “Set 
DriveB y”, x and y should be virtual SOS device numbers 
such as 2 or 3. 


B.4 Messenger Filenames 


Messenger filenames with correct suffixes for this 
environment: 


MAIL.CODE 
MAILHELP.TEXT 
MAILINFO.TEXT 
MAILNEWS.TEXT 
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Installation and Maintenance 
of the Messenger Program in the IBM PC 
UCSD p-System Environment 


C.0 Introduction 


This appendix provides instructions and information 
specific to installation and maintenance of the 
electronic mail software in the IBM PC UCSD p-System 
Environment. 


It contains the following: 


Instructions for installation of the Messenger 
software in the IBM PC UCSD p-System environment. 


instructions for maintenance of the Messenger 
software in the IBM PC UCSD p-System environment. 


C.1 Installation of the Messenger Electronic Mail 
Program in the IBM PC UCSD p-System Environment 


To install the Messenger, boot an IBM PC that uses the 
Nestar-distributed default profile, which displays the 
Nestar boot menu after power-on. (Profiles and menus 
are discussed in Chapter 1 of the PLAN Series IBM PC 
User’s Guides.) 


Press function key F9 (System Management). In response 
to “Password?” type NESTAR. Next press F4 (Installation 
Procedures). 


Finally, press the function key for the p-System 
environment. This function key will mount 


//PRODUCTS/MESSENGER/X.X/IBMPC/UCSD/PASCAL 


IBM PC p-System 


on drive 5. The distributed library volume will be 
mounted on drive 4. The system will then boot from 
drive 4. 


The Startcmd file on drive 5 will be read and 
interpreted. The install program from Messenger will 
then be run. 


You have now finished the installation procedure for the 
IBM PC UCSD p-System environment. Now turn back to the 
main body of this manual and follow the instructions for 
configuring the electronic mail software software. 


C.2 Maintenance of the Electronic Mail Program 


Each time a new user is added to the network, create a 
new mail volume for that user. 


//USERS/userid/NEWMAIL a 


See Chapter 2 for details. Users may also require 
assistance in setting up the defaults file for use with 
the Messenger program. This procedure is described in 
Chapter 7 in the Messenger User's Manual. 


C.3 Automatic Startup 
NETWORK.START 


NETWORK.START is a program that can run automatically 

when the user station is booted. NETWORK.START first 

checks the work disk for a file named SYSTEM.STARTUP. 

If present, SYSTEM.STARTUP is chained to. Otherwise, 
NETWORK.START attempts to read a file from the work disk 
called STARTCMD.TEXT, and interprets each line as a À 
command. including the word “MAIL” as a command line in ~~ 
STARTCMD.TEXT will cause the mail system to be run 
automatically when the station is booted. 
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NETWORK.START commands that do not relate to the mail 
system are described in detail in the PLAN File Server 
User’s Manual. 


DEFAULTS.TEXT 


When the Messenger is executed its first action to read 
the file DEFAULTS.TEXT, if it exists on the work volume. 
Any command lines in this textfile that begin with the 
word “MAIL:” are executed automatically. Section 3.2 
explains what mail commands can be in DEFAULTS.TEXT. In 
the commands “Set DriveA x” and “Set DriveB y”, the x 

and y should be Pascal drive numbers such as 9 or 10. 


C.4 Messenger Filenames 


Messenger filenames with correct suffixes for this 
environment: 


MAIL.CODE 
MAILHELP. TEXT 
MAILINFO.TEXT 
MAILNEWS.TEXT 
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Appendix D 


Installation and Maintenance 
of the Messenger Program in the IBM PC 
DOS Environment 


D.0 Introduction 

This appendix provides instructions and information 
specific to installation and maintenance of the 

electronic mail software in the IBM PC DOS Environment. 


it contains the following: 


Instructions for installation of the Messenger 
software in the IBM PC DOS environment. 


Instructions for maintenance of the Messenger 
software in the IBM PC DOS environment. 


D.1 Installation of the Messenger Electronic Mail 
Program in the IBM PC DOS Environment 


To install the Messenger, boot an IBM PC that uses the 
Nestar-distributed default profile, which displays the 
Nestar boot menu after power-on. (Profiles and menus 
are discussed in Chapter 1 of the PLAN Series IBM PC 
User’s Guides.) 

Press function key F9 (System Management). 

Next press function key F4 (Installation Procedures). 


Next press the function key for the DOS environment. 
This function key will mount 


//PRODUCTS/MESSENGER/X.X/IBMPC/DOS2.0 


IBM PC DOS 


on drive E: or F:. The distributed library volume will 

be mounted on C:, and the system will boot from C:. The 
autoexec.bat file on the library volume will find the 
autoexec.bat file on the products volume and the install om 
program for Messenger will be run. This and the 
subsequent installation happen automatically. 


eo" 


You have now finished the installation procedure for the 
IBM PC DOS environment. Now turn back to the main body 
of this manual and follow the instructions for 

configuring the electronic mail software software. 


D.2 Maintenance of the Electronic Mail Program 


Each time a new user is added to the network, create a 
new mail volume for that user. 


//YQURPREFIX/USERID/NEWMAIL 
See Chapter 2 for details. Users may also require oe 
assistance in setting up the defaults file for use with 
the Messenger program. This procedure is described in 
Chapter 7 in the Messenger User's Manual. 
D.3 Automatic Startup 
STARTUP 
To run the mail program automatically at power on, the 
file AUTOEXC.BAT should be on the user’s boot diskette, 
and should contain the line 
X:MAIL 
where X: is the drive upon which the library volume M 
containing the mail program is mounted (usually drive sc 


L:). X:MAIL runs the mail program. 


The library volume should be mounted automatically at 
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startup by including a MOUNT command in the workstation 
profile volume or AUTOEXC.BAT file on the boot volume. 


DEFAULTS 


When the Messenger is executed its first action to read 
the file DEFAULTS, if it exists on the work volume. Any 
command lines in this textfile that begin with the word 
“MAIL:” are executed automatically. Section 3.2 

explains what mail commands can be in DEFAULTS. In the 
commands “Set DriveA x” and “Set DriveB y”, the x and y 
should be DOS drive letters such as F or G. Do not use 
the boot drive or drive containing the library volume. 


D.4 Messenger Filenames 


In this environment the filenames that form the 
Messenger product are: 


MAIL.EXE 
MAILHELP 
MAILINFO 
MAILNEWS 
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INDEX 


A 


access rights 3-3 

Apple /// SOS B-1 

Apple // Pascal A-1 

AUTOEXEC.BAT D-2 

automatic startup 3-1, A-2, B-3, C-2, D-2 
autosetting mail file pathname 2-1 
available drives 2-4 
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CHECK command 2-3, 3-3 
CREATE access 3-4 

creating users mail file 2-1, 2-3 
current user default directory 2-4 


defaults 2-1, 2-2 
Defaults file 2-2, 2-3, 3-1, A-3, B-3, C-3, D-3 
DELETE access 3-4 
directory 
NEWMAIL 2-2,3-3 
user default 2-4 
disclaimer ii 
distribution volumes 1-2, A-1, B-1, C-1, D-1 


INDEX 


DOS (IBM-PC) D-1 
drives used 2-4, 3-2 


environments 1-1, A-1, B-1, C-1, D-1 
executing the Messenger program 2-1 


F 


“FAILED READING BLOCK...” 2-4 

file protection 3-3 

filenames, Messenger A-3, B-4, C-3, D-3 
files, mail program 1-1 

FS command mode 2-4 


height of screen 3-2 
HELP command 1-1 


IBM PC DOS D-1 

IBM PC UCSD p-System C-1 
incoming mail identification 2-2 
INFO command 1-1 

installation 1-1ff, A-1, B-1, C-1, D-1 


M 
MAIL 1-1, 2-1, 2-2 
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INDEX 


mail files, 

pathname 2-1 

program 1-1, 1-2 

size 2-3 

user 2-1 
Mail.Code 1-1 
Mail: commands 3-1, 3-2 
Mailhelp.Text 1-1 
Mailinfo.Text 1-1 
Mailnews.Text 1-1 
/MAIN/PRODUCTS/MESSENGER/X.X 1-2, A-1, B-1, C~1, D-1 
maintenance A-2, B-3, C-2, D-2 
message identification number 2-2 
MORE?(Y,N) 3-2 
mounting MAIL and NEWMAIL 2-2 thru 2-4 
multiple recipients (CC:s) 2-2 


“name” (user) 3-2 

NESTAR.START A-2, B-3, C-2 

NET command 2-4 

network file protection 3-3 

NEWMAIL directory 2-2, 2-3 

news and information files 1-1 

NEWS command 1-1 

“Not found: /MAIN/USERS/SMITH/MAIL” 2-3 
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operation of mail program 2-1ff 
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INDEX 


Pascal A-1, B-2 
password, private 3-4 
“path” 3-3 
pathname of mail file 2-1 
pathname of NEWMAIL directory 2-2, 2-3 
prefix 
mail file pathname 2-1 
NEWMAIL directory 2-2 
prefix/userID/NEWMAIL 2-2 
prequisite manuals iii 
private password 3-4 
protection 3-3 


READ access 3-4 
READ command 2-3, 3-3 
“restoring” the mail software at installation 1-2 


screen dimensions 3-2 

SET commands (startup) 3-2 

Shared library volumes 1-2, A-1, B-1, C-1, D-1 
size of MAIL files 2-3 

SOS B-1 

Startcmd file 3-1 

Swapping (Apple // Pascal) A-3 

system manager duties iii, 1-1 
SYSTEM.STARTUP A-2, B-3, C-2 


tailoring your system 3-1ff 
tape cartridge containing program files 1-2 
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INDEX 


UCSD p-System C-1 
unauthorized use of mail system 3-5 
usage rights 3-3 
user name 3-2 
user’s default directory 2-4 
user's identification 
(in mail file pathname) 2-1 
user’s mail file 2-1 


version number iii 
virtual drives, 
Messenger programs need for 2-4 
volumes that contain mail program files 1-1, 1-2 


W 


"Who are you?” 2-3 
width of screen 3-2 
WRITE access 3-4 
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Reader Comment Form 


This manual is one in a series that describes the use of 
the PLAN Series systems. 


You are encouraged to use this form to communicate to 
Nestar any problems or suggestions associated with the 
system. We would like your comments on improving the 
system itself, as well as on this documentation. 

Possible topics for comment are: clarity, accuracy, 
completeness, organization, coding, retrieval, and 
tegibility. 


No postage stamp is necessary if mailed within the 
U.S.A. 

Nestar installation location: 

Submitter’s name: 


Address: 


Description of problem or suggestion: 


Please mail this form to: Nestar Systems, Incorporated 
2585 E. Bayshore Road 
Palo Alto, California 94303 
Attn: PUBLICATIONS DEPT. 
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